Summary

• non-breaking code cleanup/organization in the repository layer.
• Improved serialization and removed duplication between cache handler and normal serializers
• Bug Fixes

Detailed Changes

Repository & Caching Refactor

• Reduced Bloat: Moved internal caching helpers (_normalize_cache_key_value, _build_list_cache_key, etc.) out of advanced_alchemy/repository/_async.py and into advanced_alchemy/repository/_util.py.
• Unified Serialization:
  • Refactored advanced_alchemy/_serialization.py to expose encode_complex_type and decode_complex_type.
  • Updated advanced_alchemy/cache/serializers.py and repository/_util.py to share this logic, removing duplicate handling for types like UUID, datetime, and Decimal.
• Cleanup: Removed unused imports (dataclasses, hashlib, etc.) from the repository files.

Bug Fixes

• Issue Bug: SQLAlchemy's StatementError (or OperationalError) is incorrectly wrapped as IntegrityError #606 (Error Misclassification):
  • Problem: StatementError (often caused by transient connection issues) was incorrectly wrapped as IntegrityError.
  • Fix: Updated advanced_alchemy/exceptions.py to correctly map StatementError to RepositoryError.
• Issue Bug: Core dependencies not installed by default #651 (Alembic Migrations):
  • Problem: Migration templates unconditionally imported optional dependencies (Argon2, Passlib, Pwdlib), causing crashes for users who hadn't installed them.
  • Fix: Wrapped these imports in try/except ImportError blocks in both sync and asyncio Alembic templates (script.py.mako).
• Issue Bug: Problem with certain hybrid properties starting with 1.8.0 #646 (DTO Regression):
  • Problem: SQLAlchemyDTO crashed when encountering hybrid_property attributes because inspect.getmembers triggered their evaluation.
  • Fix: Switched to iterating over the class dictionary (dict) and MRO in dto.py to inspect properties safely without executing them.